quick-xml
High performance xml pull reader/writer.
The reader:
- is almost zero-copy (use of
Cow
whenever possible) - is easy on memory allocation (the API provides a way to reuse buffers)
- support various encoding, namespaces resolution, special characters.
Syntax is inspired by xml-rs.
Usage
[]
= "0.7.0"
extern crate quick_xml;
Example
Reader
use Reader
use Event;
let xml = r#"<tag1 att1 = "test">
<tag2><!--Test comment-->Test</tag2>
<tag2>
Test 2
</tag2>
</tag1>"#;
let mut reader = from_str;
reader.trim_text;
let mut count = 0;
let mut txt = Vec new;
let mut buf = Vec new;
// The `Reader` does not implement `Iterator` because it outputs borrowed data (`Cow`s)
loop
Writer
use Writer;
use Reader;
use ;
use Cursor;
use iter;
let xml = r#"<this_tag k1="v1" k2="v2"><child>text</child></this_tag>"#;
let mut reader = from_str;
reader.trim_text;
let mut writer = new;
let mut buf = Vec new;
loop
let result = writer.into_inner.into_inner;
let expected = r#"<my_elem k1="v1" k2="v2" my-key="some value"><child>text</child></my_elem>"#;
assert_eq!;
Performance
quick-xml is around 40 times faster than xml-rs crate.
// quick-xml benches
test bench_quick_xml ... bench: 336,590 ns/iter (+/- 15,800)
test bench_quick_xml_escaped ... bench: 433,673 ns/iter (+/- 17,880)
test bench_quick_xml_namespaced ... bench: 501,155 ns/iter (+/- 107,318)
// same bench with xml-rs
test bench_xml_rs ... bench: 13,022,289 ns/iter (+/- 1,532,129)
Contribute
Any PR is welcomed!
License
MIT